Kompletna tehnička referenca za svih 8 HTML5 Web Komponenti (HTML struktura, unutrašnji tagovi za CSS stilizaciju, pojedinačni atributi, JavaScript metode i događaji).
0. Instalacija, Auto-load i Globalni CSS Osnova sistema
Biblioteka zahteva samo uključivanje modals.js fajla. Na samom početku izvršavanja, modals.js čita document.currentScript.src, izdvaja tačnu putanju foldera u kom se nalazi i automatski u <head> ubacuje <link rel="stylesheet" href="...modals.css">. Time se u potpunosti zaobilazi eventualni <base href="/"> tag na stranici.
RGB vrednost boje zatamnjene pozadine (::backdrop) iza svih modala. Koristi se unutar rgba(var(--modal_backdrop), 0.5) ili 0.8.
--modal_box_background
98, 98, 98
RGB vrednost boje pozadine dijaloških prozora (modal-box, modal-confirm, modal-alert, modal-wizard, modal-toast).
--modal_box_color
255, 255, 255
RGB vrednost boje teksta, linija razdvajanja i SVG ikonica unutar dijaloških prozora.
body:has(...:popover-open)
overflow: hidden
Automatski zamrzava skrolovanje glavne stranice dok je otvoren bilo koji blokirajući modal.
body:has(...:popover-open)::after
position: fixed; inset: 0; z-index: 20;
Fizički, nevidljivi štit preko cele stranice koji sprečava hover efekte i klikove na pozadinske elemente dok je modal otvoren.
.modal-btn
Osnovni stil dugmeta
Opšta klasa za dugmad unutar modala (padding, заobljene ivice, efekat klika).
.modal-btn-confirm
background-color: #3498db
Plavo dugme za primarnu akciju / potvrdu.
.modal-btn-cancel
background-color: rgba(255,255,255,0.2)
Poluprovidno dugme za odustajanje / povratak.
1. <modal-box> — Standardni prozor Osnovni dijalog
Osnovna komponenta za prikazivanje dijaloga, formi, tabela ili obaveštenja. Sama kreira dugme za zatvaranje i upravlja režimima zaključavanja.
Struktura HTML-a
<modal-box id="moj_modal" persistent>
<modal-header>Naslov prozora</modal-header>
<modal-main>
<p>Glavni sadržaj modala koji dobija vertikalni skrol ako pređe visinu ekrana.</p>
</modal-main>
<modal-footer>
<button class="modal-btn modal-btn-cancel" onclick="document.getElementById('moj_modal').hide()">Zatvori</button>
<button class="modal-btn modal-btn-confirm">Sačuvaj</button>
</modal-footer>
</modal-box>
Unutrašnji tagovi i CSS selektori u okviru <modal-box>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-box
Piše korisnik
Glavni kontejner prozora (dimenzije, background-color, border-radius, padding, box-shadow).
modal-box:popover-open
CSS stanje
Aktivno stanje kada je modal otvoren (uključuje display: flex; flex-direction: column;).
modal-box::backdrop
Pseudo-element
Zatamnjena i zamućena pozadina iza modala (background-color i backdrop-filter: blur(5px)).
modal-close
Generiše JS
Dugme X u gornjem desnom uglu (top: 15px; right: 20px;). Automatski se ubacuje na početak modala.
modal-close svg
Generiše JS
Vektorska SVG ikonica unutar modal-close dugmeta (dimenzije 30px x 30px, boja fill: currentColor).
modal-header
Piše korisnik
Gornje zaglavlje prozora (veličina fonta 1.4rem, bold, donja linija border-bottom).
modal-main
Piše korisnik
Centralni deo prozora za glavni sadržaj (ima flex: 1 i overflow-y: auto za automatsko skrolovanje).
modal-footer
Piše korisnik
Donji deo prozora namenjen za dugmad (display: flex, gornja linija border-top, razmak gap: 10px).
Podržani HTML Atributi
Atribut
Moguće vrednosti
Detaljan opis ponašanja
persistent
prazno, "true" ili "false"
Prebacuje modal u popover="manual" režim. Sprečava zatvaranje modala klikom na sivu pozadinu (backdrop) i pritiskom na taster Escape. Dugme X (<modal-close>) ostaje vidljivo i funkcionalno.
locked
prazno, "true" ili "false"
Prebacuje modal u popover="manual" režim, sprečava zatvaranje klikom na pozadinu i tasterom Escape, i putem CSS-a sakriva X dugme (display: none !important). Korisnik može zatvoriti modal isključivo ako mu to omogućiš preko JS metode .hide().
forced
prazno, "true" ili "false"
Najstroži nivo zaključavanja. Ponaša se isto kao locked (nema zatvaranja na pozadinu/ESC i sakriveno je X dugme), ali dodatno aktivira window.onbeforeunload zaštitu koja sprečava korisnika da osveži stranicu (F5 / Reload) ili zatvori karticu pregledača dok je modal otvoren.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
modal.show()
nema
Proverava trenutne atribute zaključavanja i otvara modal na ekranu (poziva nativni showPopover()).
modal.hide()
nema
Zatvara modal (poziva nativni hidePopover()) i vraća skrol glavnoj stranici.
modal.persistent(state)
state: true ili false
Dinamički postavlja ili uklanja atribut persistent. Može se pozvati i dok je modal već otvoren bez njegovog zatvaranja.
modal.locked(state)
state: true ili false
Dinamički postavlja ili uklanja atribut locked (trenutno sakriva ili prikazuje X dugme).
modal.forced(state)
state: true ili false
Dinamički postavlja ili uklanja atribut forced i odmah ažurira beforeunload zaštitu od osvežavanja stranice.
addEventListener('toggle', fn)
event objekat
Nativni Popover događaj koji se okida pri svakom otvaranju (event.newState === "open") i zatvaranju (event.newState === "closed").
Interaktivni primeri za <modal-box>
Standardni Modal Box
Probaj da klikneš na sivu pozadinu, na X u uglu ili pritisni ESC na tastaturi.
2. <modal-picture> — Prikaz pojedinačne slike Zoom & Fullscreen
Komponenta za prikazivanje slike preko celog ekrana sa automatskim spinerom dok se slika učitava, naprednim zumiranjem u tačku kursora/prstiju, panovanjem i podrškom za Fullscreen API.
Struktura HTML-a
<modal-picture id="moja_slika" zoom persistent>
<picture>
<img src="slika-visoke-rezolucije.jpg" alt="Opis slike">
</picture>
<picture-title>Naslov slike</picture-title>
<picture-description>Detaljan opis slike ispod naslova...</picture-description>
</modal-picture>
Unutrašnji tagovi i CSS selektori u okviru <modal-picture>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-picture
Piše korisnik
Glavni kontejner preko celog ekrana (width: 100%; height: 100%; background: transparent;).
modal-picture:popover-open
CSS stanje
Aktivno stanje kada je modal otvoren (display: flex; justify-content: center; align-items: center;).
modal-picture::backdrop
Pseudo-element
Tamna pozadina iza slike (rgba(var(--modal_backdrop), 0.8) sa backdrop-filter: blur(5px)).
modal-close
Generiše JS
Belo dugme X u gornjem desnom uglu ekrana (top: 20px; right: 30px;).
modal-fullscreen
Generiše JS
Belo dugme za Fullscreen režim smešteno levo od X dugmeta (top: 21px; right: 70px;).
modal-loader
Generiše JS
Animirani kružni spiner na sredini ekrana koji se prikazuje dok se slika ne učita sa servera, a zatim se sam briše.
picture
Piše korisnik
Omotač oko <img> elementa koji centrira sliku na ekranu.
img
Piše korisnik
Sama slika (podrazumevano ograničena na max-width: calc(100vw - 140px); max-height: calc(100vh - 144px); object-fit: contain;).
picture-info
Generiše JS
Donji kontejner sa tamnim gradijentom u koji JS automatski premešta <picture-title> i <picture-description>. Ima pointer-events: none kako ne bi smetao pri prevlačenju zumirane slike.
picture-title
Piše korisnik
Naslov slike na dnu ekrana (poluprovidna tamna pozadina sa backdrop-filter: blur(5px) i zaobljenim ivicama).
picture-description
Piše korisnik
Opis slike ispod naslova (manji font 0.9rem, poluprovidna pozadina sa blur efektom).
Podržani HTML Atributi
Atribut
Na kom tagu se piše
Detaljan opis ponašanja
zoom
<modal-picture>
Dozvoljava uveličavanje slike u rasponu od 1x do 5x (točkićem miša, tasterima +/- ili štipanjem sa dva prsta). Ne dozvoljava smanjivanje slike ispod njene početne veličine (1x).
zoom-free
<modal-picture>
Dozvoljava slobodno skaliranje slike u rasponu od 0.2x (umanjenje) do 5x (uvećanje), kao i slobodno prevlačenje (panovanje) čak i kada je slika manja od ekrana.
class="zoom_in"
<img>
Alternativni način da uključiš standardni zum (1x do 5x) dodavanjem CSS klase direktno na <img> tag umesto atributa na modalu.
class="zoom_free"
<img>
Alternativni način da uključiš slobodni zum (0.2x do 5x) dodavanjem CSS klase direktno na <img> tag.
persistent
<modal-picture>
Sprečava zatvaranje modala klikom na tamnu pozadinu oko slike i pritiskom na taster Escape. Dugme X ostaje vidljivo.
locked
<modal-picture>
Sprečava zatvaranje klikom na pozadinu i tasterom Escape, i sakriva X dugme. Modal se može zatvoriti samo putem JS metode .hide().
forced
<modal-picture>
Sprečava zatvaranje na pozadinu/ESC, sakriva X dugme i blokira osvežavanje (F5) ili zatvaranje stranice dok je slika otvorena.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
picModal.show()
nema
Otvara modal sa slikom i aktivira kontrole tastature za zumiranje i panovanje.
picModal.hide()
nema
Zatvara modal, resetuje zum i poziciju slike na početne vrednosti (1x) i automatski izlazi iz Fullscreen režima ukoliko je bio aktivan.
picModal.toggleFullscreen()
nema
Prebacuje prikaz u nativni Fullscreen režim (ili izlazi iz njega) bez zatvaranja modala i bez gubitka trenutnog zuma.
picModal.persistent(state)
state: true ili false
Dinamički pali ili gasi persistent zaštitu od zatvaranja klikom na pozadinu.
picModal.locked(state)
state: true ili false
Dinamički pali ili gasi locked režim (sakriva/prikazuje X dugme).
picModal.forced(state)
state: true ili false
Dinamički pali ili gasi forced režim i zaštitu od osvežavanja stranice.
addEventListener('toggle', fn)
event objekat
Okida se kada se modal slike otvori (event.newState === "open") ili zatvori (event.newState === "closed").
Interaktivni primeri za <modal-picture>
Standardni Zoom (1x do 5x)Koristi točkić miša, +/- na tastaturi, strelice za pomeranje ili dvoklik za reset.Slobodni Zoom-Free (0.2x do 5x)Ovde možeš odzumirati sliku ispod 100% i slobodno je pomerati po ekranu.
3. <modal-gallery> — Galerija slika Slajdovi + Autoplay
Komponenta za pregled više slika sa animiranim prelazima, navigacionim strelicama, tačkicama (indikatorima), Swipe podrškom na mobilnim ekranima, prilagodljivim Autoplay tajmerom i pojedinačnim zumiranjem svakog slajda.
Unutrašnji tagovi i CSS selektori u okviru <modal-gallery>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-gallery
Piše korisnik
Glavni kontejner galerije preko celog ekrana.
modal-gallery:popover-open
CSS stanje
Aktivno stanje otvorene galerije (display: flex).
modal-gallery::backdrop
Pseudo-element
Zatamnjena i zamućena pozadina iza galerije.
modal-close
Generiše JS
Dugme X za zatvaranje galerije u gornjem desnom uglu (top: 21px; right: 20px;).
modal-fullscreen
Generiše JS
Dugme za Fullscreen režim u gornjem desnom uglu (top: 21px; right: 70px;).
gallery-playpause
Generiše JS
Dugme za pauziranje i pokretanje Autoplay-a u gornjem desnom uglu (top: 21px; right: 120px;). Prikazuje se samo kada galerija ima uključen autoplay.
gallery-dots
Generiše JS
Kontejner sa tačkicama za navigaciju centriran na vrhu ekrana (top: 20px; left: 50%;). Kreira se automatski ako galerija ima više od 1 slike.
.gallery-dot
Generiše JS
Pojedinačna tačkica (span.gallery-dot) unutar <gallery-dots> kontejnera.
.gallery-dot.active
CSS stanje
Trenutno aktivna tačkica (puna bela boja i uvećanje scale(1.2)).
gallery-prev
Generiše JS
Veliko dugme sa strelicom ulevo uz levu ivicu ekrana (left: 0px). Na ekranima užim od 768px automatski se sakriva jer se koristi Swipe.
gallery-next
Generiše JS
Veliko dugme sa strelicom udesno uz desnu ivicu ekrana (right: 0px).
modal-loader
Generiše JS
Kružni spiner koji se prikazuje dok se slika novog slajda ne učita.
picture
Piše korisnik
Omotač pojedinačnog slajda. Svaki <picture> unutar <modal-gallery> predstavlja jedan slajd.
picture.gallery-fade-in
CSS animacija
Klasa koja pokreće glatku galleryFadeInAnim animaciju pri promeni slajda.
img
Piše korisnik
Slika unutar <picture> slajda.
picture-info
Generiše JS
Donji kontejner sa gradijentom koji JS automatski kreira za svaki slajd i u njega prebacuje pripadajući naslov i opis.
picture-title
Piše korisnik
Naslov slajda (piše se u HTML-u odmah ispod <picture> taga na koji se odnosi).
picture-description
Piše korisnik
Opis slajda (piše se u HTML-u odmah ispod <picture> ili <picture-title> taga).
Podržani HTML Atributi
Atribut
Na kom tagu se piše
Detaljan opis ponašanja
autoplay
<modal-gallery>
Ako se navede samo autoplay (ili autoplay="true"), galerija automatski menja slajdove na svakih 5 sekundi i prikazuje Play/Pause dugme.
autoplay="X"
<modal-gallery>
Postavlja prilagođeni interval automatskog menjanja slajdova na X sekundi (npr. autoplay="3" menja slajd na 3 sekunde, autoplay="15" na 15 sekundi).
loop
<modal-gallery>
Kontroliše kružno kretanje kroz slajdove. Podrazumevano je "true" (posle poslednje slike prelazi na prvu). Ako se postavi loop="false", strelica za nazad se sakriva na prvom slajdu, a strelica za napred se sakriva na poslednjem slajdu.
zoom
<modal-gallery>
Dozvoljava zumiranje (uveličavanje od 1x do 5x) na svim slikama u galeriji. Dok je slika zumirana, strelice na tastaturi pomeraju sliku (pan), a autoplay je privremeno pauziran.
zoom-free
<modal-gallery>
Dozvoljava slobodno zumiranje i odzumiranje (od 0.2x do 5x) na svim slikama u galeriji.
class="zoom_in"
<img>
Omogućava standardni zum (1x do 5x) samo na onoj slici u galeriji na čiji je <img> tag dodata ova klasa.
class="zoom_free"
<img>
Omogućava slobodni zum (0.2x do 5x) samo na onoj slici u galeriji na čiji je <img> tag dodata ova klasa.
persistent
<modal-gallery>
Sprečava zatvaranje galerije klikom na tamnu pozadinu oko slike i pritiskom na Escape. Dugme X ostaje vidljivo.
locked
<modal-gallery>
Sprečava zatvaranje klikom na pozadinu i tasterom Escape, i sakriva X dugme.
forced
<modal-gallery>
Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok je galerija otvorena.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
galerija.show()
nema
Otvara galeriju i automatski pokreće autoplay tajmer ukoliko element ima autoplay atribut.
galerija.hide()
nema
Zatvara galeriju, zaustavlja autoplay tajmer, resetuje zum i izlazi iz Fullscreen-a ako je bio uključen.
galerija.showSlide(index, resetTimer)
index: broj (od 0) resetTimer: boolean (default true)
Prikazuje slajd sa zadatim indeksom (0 je prva slika), ažurira aktivnu tačkicu i resetuje zum.
galerija.next()
nema
Prelazi na sledeći slajd u galeriji (poštujući loop podešavanje).
galerija.prev()
nema
Vraća se na prethodni slajd u galeriji (poštujući loop podešavanje).
galerija.play()
nema
Programski uključuje i pokreće autoplay (ako atribut autoplay nije postojao, postavlja ga na podrazumevanih 5 sekundi) i menja ikonicu u Pause.
galerija.pause()
nema
Programski pauzira autoplay tajmer i menja ikonicu dugmeta u Play (trougao).
galerija.togglePlayPause()
nema
Prebacuje stanje između Play i Pause režima.
galerija.setAttribute('autoplay', '10')
Naziv atributa i broj sekundi
Zahvaljujući observedAttributes praćenju, promena vrednosti autoplay atributa kroz JS odmah menja brzinu smenjivanja slajdova u letu.
galerija.toggleFullscreen()
nema
Prebacuje galeriju u Fullscreen režim (ili izlazi iz njega) bez zatvaranja galerije.
galerija.persistent(state)
state: true ili false
Dinamički uključuje ili isključuje persistent režim.
galerija.locked(state)
state: true ili false
Dinamički uključuje ili isključuje locked režim (sakriva/prikazuje X dugme).
galerija.forced(state)
state: true ili false
Dinamički uključuje ili isključuje forced režim i zaštitu od osvežavanja stranice.
addEventListener('toggle', fn)
event objekat
Okida se pri otvaranju (event.newState === "open") i zatvaranju (event.newState === "closed") galerije.
Interaktivni primeri za <modal-gallery>
1. Šumski pejzažAutoplay je podešen na 3 sekunde. Ako zumiraš sliku, autoplay čeka dok ne resetuješ zum.2. Planinsko jezeroMožeš menjati slike strelicama na tastaturi, klikom na tačkice gore ili prevlačenjem prsta (Swipe).3. VodopadKlikni na Pause ikonicu ili Fullscreen dugme u gornjem desnom uglu.Slajd 1 (Početak niza)Pošto je loop="false", leva strelica ovde ne postoji.Slajd 2 (Sredina)Ovde su vidljive obe strelice.Slajd 3 (Kraj niza)Desna strelica je sakrivena jer nema više slajdova.
Nasleđuje ModalBox i služi za asinhrono postavljanje pitanja korisniku sa dva odgovora (Potvrdi / Odustani). Vraća Promise<boolean> pa se koristi uz async / await sintaksu.
Struktura HTML-a
<!-- Varijanta 1: Sa unapred definisanim tekstom -->
<modal-confirm id="potvrda_brisanja" title="Brisanje naloga" ok-text="Obriši" cancel-text="Odustani" persistent>
<modal-main>Da li ste sigurni da želite trajno da obrišete nalog?</modal-main>
</modal-confirm>
<!-- Varijanta 2: Prazan element kom se pitanje i naslov šalju kroz .ask(poruka, naslov) -->
<modal-confirm id="univerzalni_confirm"></modal-confirm>
Unutrašnji tagovi i CSS selektori u okviru <modal-confirm>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-confirm
Piše korisnik
Glavni kontejner prozora (nasleđuje izgled modal-box-a, min-width: 320px).
modal-confirm:popover-open
CSS stanje
Aktivno stanje kada je prozor otvoren (display: flex; flex-direction: column;).
modal-confirm::backdrop
Pseudo-element
Zatamnjena i zamućena pozadina iza prozora.
modal-close
Generiše JS
Dugme X u gornjem desnom uglu. Klik na X automatski razrešava Promise sa vrednošću false.
modal-header
Piše korisnik ili JS
Zaglavlje sa naslovom pitanja. Ako ga ne napišeš u HTML-u, JS ga sam kreira iz atributa title.
modal-main
Piše korisnik ili JS
Centralni deo u kom stoji tekst pitanja. Ako ga ne napišeš u HTML-u, JS ga sam kreira.
modal-footer
Generiše JS
Donji kontejner u kom se nalaze dugmad za odustajanje i potvrdu.
button.modal-btn-cancel
Generiše JS
Dugme za odustajanje (klik vraća false).
button.modal-btn-confirm
Generiše JS
Plavo dugme za potvrdu (klik vraća true).
Podržani HTML Atributi
Atribut
Moguće vrednosti
Detaljan opis ponašanja
title
Tekst (npr. "Potvrda")
Postavlja tekst u automatski generisanom <modal-header> tagu. Podrazumevana vrednost je "Potvrda".
ok-text
Tekst (npr. "Da, obriši")
Postavlja tekst na plavom dugmetu za potvrdu. Podrazumevana vrednost je "Potvrdi".
cancel-text
Tekst (npr. "Ne")
Postavlja tekst na dugmetu za odustajanje. Podrazumevana vrednost je "Odustani".
persistent
prazno, "true" ili "false"
Sprečava zatvaranje dijaloga klikom na sivu pozadinu ili tasterom Escape. Dugme X ostaje vidljivo.
locked
prazno, "true" ili "false"
Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme, tako da korisnik mora da klikne na jedno od dva ponuđena dugmeta u footeru.
forced
prazno, "true" ili "false"
Isto kao locked, plus blokira osvežavanje (F5) ili zatvaranje stranice dok korisnik ne odgovori na pitanje.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
await confirmModal.ask(message, title)
message (opciono): tekst pitanja title (opciono): novi naslov
Otvara modal i vraća Promise<boolean>. Vraća true ako korisnik klikne na dugme za potvrdu, a false ako klikne na Odustani, X, pozadinu ili Escape. Funkcija u kojoj pozivaš await mora biti označena sa async.
confirmModal.show()
nema
Otvara dijalog bez kreiranja novog Promise-a (korisno ako slušaš događaje confirm i cancel).
confirmModal.hide()
nema
Zatvara dijalog (ako je bio aktivan Promise, razrešava ga sa false).
confirmModal.persistent(state)
state: true ili false
Dinamički uključuje ili isključuje persistent režim.
confirmModal.locked(state)
state: true ili false
Dinamički uključuje ili isključuje locked režim (sakriva/prikazuje X dugme).
confirmModal.forced(state)
state: true ili false
Dinamički uključuje ili isključuje forced režim.
addEventListener('confirm', fn)
CustomEvent
Okida se kada korisnik klikne na dugme za potvrdu (event.detail === true).
addEventListener('cancel', fn)
CustomEvent
Okida se kada korisnik klikne na dugme za odustajanje (event.detail === false).
addEventListener('toggle', fn)
event objekat
Nativni događaj otvaranja i zatvaranja prozora.
Interaktivni primeri za <modal-confirm>
Status: Čeka se akcija korisnika...
Da li ste sigurni da želite trajno da obrišete izabrani zapis iz baze podataka?
Nasleđuje ModalBox i služi za prikazivanje statusnih poruka sa jednim dugmetom za potvrdu i automatskom SVG ikonicom u zaglavlju.
Struktura HTML-a
<modal-alert id="moj_alert" type="success" title="Uspešno" ok-text="U redu">
<modal-main>Podaci su uspešno sačuvani!</modal-main>
</modal-alert>
Unutrašnji tagovi i CSS selektori u okviru <modal-alert>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-alert
Piše korisnik
Glavni kontejner prozora obaveštenja.
modal-alert:popover-open
CSS stanje
Aktivno stanje kada je prozor otvoren (display: flex).
modal-alert::backdrop
Pseudo-element
Zatamnjena i zamućena pozadina iza prozora.
modal-close
Generiše JS
Dugme X u gornjem desnom uglu.
modal-header
Piše korisnik ili JS
Zaglavlje u kom se nalaze statusna ikonica i naslov obaveštenja.
span.modal-status-icon
Generiše JS
Omotač statusne SVG ikonice (26px x 26px) koji se automatski ubacuje na početak modal-header-a kada postoji atribut type.
modal-main
Piše korisnik ili JS
Centralni deo sa tekstom obaveštenja.
modal-footer
Generiše JS
Donji deo prozora sa dugmetom za zatvaranje.
button.modal-btn-confirm
Generiše JS
Dugme za zatvaranje obaveštenja (podrazumevano piše "U redu").
Podržani HTML Atributi
Atribut
Moguće vrednosti
Detaljan opis ponašanja
type="info"
"info"
Postavlja plavu informacionu SVG ikonicu (#3498db) u zaglavlje modala.
type="success"
"success"
Postavlja zelenu SVG ikonicu potvrde/uspeha (#2ecc71) u zaglavlje modala.
type="warning"
"warning"
Postavlja žutu SVG ikonicu upozorenja — trougao sa uzvičnikom (#f1c40f) u zaglavlje modala.
type="error"
"error"
Postavlja crvenu SVG ikonicu greške (#e74c3c) u zaglavlje modala.
title
Tekst
Tekst naslova u <modal-header> tagu (podrazumevano "Obaveštenje").
ok-text
Tekst
Tekst na dugmetu u footeru (podrazumevano "U redu").
persistent
prazno, "true" ili "false"
Sprečava zatvaranje obaveštenja klikom na pozadinu i pritiskom na Escape.
locked
prazno, "true" ili "false"
Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme (korisnik mora da klikne na dugme "U redu").
forced
prazno, "true" ili "false"
Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok je obaveštenje otvoreno.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
await alertModal.alert(message, title, type)
message: tekst poruke title: naslov type: 'info' | 'success' | 'warning' | 'error'
Dinamički menja poruku, naslov i ikonicu, otvara modal i vraća Promise<boolean> koji se razrešava sa true tek kada korisnik zatvori prozor.
alertModal.show()
nema
Otvara postojeći alert modal bez izmene teksta.
alertModal.hide()
nema
Zatvara alert modal i razrešava aktivni Promise.
alertModal.persistent(state)
state: true ili false
Dinamički pali ili gasi persistent režim.
alertModal.locked(state)
state: true ili false
Dinamički pali ili gasi locked režim.
alertModal.forced(state)
state: true ili false
Dinamički pali ili gasi forced režim.
addEventListener('toggle', fn)
event objekat
Nativni događaj otvaranja i zatvaranja prozora.
Interaktivni primeri za <modal-alert>
6. <modal-video> — Video i YouTube / Vimeo plejer 16:9 + Start sekunda
Komponenta za prikazivanje lokalnih video fajlova (<video>) ili YouTube/Vimeo snimaka (<iframe>) u 16:9 formatu, sa podrškom za definisanje početne sekunde i automatskim gašenjem zvuka/videa pri zatvaranju modala.
Struktura HTML-a
<!-- Primer 1: Nativni HTML5 video -->
<modal-video id="moj_video" start="10" autoplay>
<video src="snimak.mp4" controls></video>
<video-title>Naslov snimka</video-title>
<video-description>Opis snimka ispod videa...</video-description>
</modal-video>
<!-- Primer 2: Direktno preko src atributa (automatski kreira iframe za YouTube/Vimeo ili video za mp4) -->
<modal-video id="yt_video" src="https://www.youtube.com/embed/aqz-KE-bpKQ" start="25" autoplay>
<video-title>YouTube Video</video-title>
</modal-video>
Unutrašnji tagovi i CSS selektori u okviru <modal-video>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-video
Piše korisnik
Glavni kontejner preko celog ekrana.
modal-video:popover-open
CSS stanje
Aktivno stanje kada je video modal otvoren (display: flex; justify-content: center; align-items: center;).
modal-video::backdrop
Pseudo-element
Zatamnjena pozadina iza videa (rgba(var(--modal_backdrop), 0.85) sa blur efektom).
modal-close
Generiše JS
Belo dugme X u gornjem desnom uglu (top: 20px; right: 30px;).
video-wrapper
Generiše JS
Kontejner sa odnosom stranica aspect-ratio: 16 / 9, crnom pozadinom, zaobljenim ivicama (border-radius: 8px) i senkom u koji JS automatski pakuje <video> ili <iframe>.
video
Piše korisnik ili JS
HTML5 video plejer (zauzima width: 100%; height: 100%; unutar video-wrapper-a).
iframe
Piše korisnik ili JS
Ugrađeni YouTube ili Vimeo iframe plejer (zauzima width: 100%; height: 100%; unutar video-wrapper-a).
picture-info
Generiše JS
Donji kontejner sa tamnim gradijentom u koji JS automatski smešta naslov i opis videa.
video-title (ili picture-title)
Piše korisnik
Naslov videa u donjem info bloku.
video-description (ili picture-description)
Piše korisnik
Opis videa ispod naslova u donjem info bloku.
Podržani HTML Atributi
Atribut
Na kom tagu se piše
Detaljan opis ponašanja
src
<modal-video>
URL adresa medija. Ako sadrži youtube.com, youtu.be ili vimeo.com, komponenta automatski kreira <iframe>. U suprotnom kreira HTML5 <video controls> element.
start
<modal-video>
Broj sekundi od kog video treba da krene pri otvaranju (npr. start="30" kreće od 30. sekunde). Radi i za HTML5 video i za YouTube/Vimeo.
start
<video>
Alternativno mesto za upisivanje početne sekunde direktno na <video start="30"> tagu unutar modala.
autoplay
<modal-video>
Automatski pokreće reprodukciju videa čim se modal otvori (kod YouTube/Vimeo plejera automatski dodaje autoplay=1 u URL).
persistent
<modal-video>
Sprečava zatvaranje video modala klikom na tamnu pozadinu oko plejera i pritiskom na Escape.
locked
<modal-video>
Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme.
forced
<modal-video>
Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok je video modal otvoren.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
videoModal.show()
nema
Otvara modal i pokreće video od početka (ili od sekunde definisane u HTML atributu start).
videoModal.show(startSeconds)
startSeconds: broj sekundi (npr. 45)
Otvara modal i pokreće video tačno od prosleđene sekunde (ovaj parametar ima prioritet nad HTML atributom start).
videoModal.hide()
nema
Zatvara modal, pauzira HTML5 video i vraća vreme na 0, odnosno prazni src atribut na <iframe>-u kako bi odmah zaustavio YouTube/Vimeo reprodukciju.
videoModal.persistent(state)
state: true ili false
Dinamički uključuje ili isključuje persistent režim.
videoModal.locked(state)
state: true ili false
Dinamički uključuje ili isključuje locked režim (sakriva/prikazuje X dugme).
videoModal.forced(state)
state: true ili false
Dinamički uključuje ili isključuje forced režim i zaštitu od osvežavanja stranice.
addEventListener('toggle', fn)
event objekat
Nativni događaj koji se okida pri otvaranju i zatvaranju video modala.
Interaktivni primeri za <modal-video>
HTML5 MP4 Video PrimerZatvaranjem modala video se automatski zaustavlja.YouTube Embed PrimerAutomatski kreće od 25. sekunde.
7. <modal-toast> i toast() — Iskačuće notifikacije Auto-stacking
Ne-blokirajuća obaveštenja koja se pojavljuju u izabranom uglu ekrana, automatski se slažu jedno iznad/ispod drugog i sama nestaju nakon zadatog broja sekundi. Mogu se pozivati direktno iz JavaScript-a bez pisanja HTML-a.
Struktura HTML-a (Opciono — ako ne koristiš globalnu JS funkciju toast())
<modal-toast id="moj_toast" type="success" duration="4" position="bottom-right">
Podaci su uspešno sačuvani!
</modal-toast>
Unutrašnji tagovi i CSS selektori u okviru <modal-toast>
Aktivno stanje otvorene notifikacije sa toastFadeIn animacijom ulaska.
modal-toast::backdrop
Pseudo-element
Uvek sakriven (display: none) kako notifikacija ne bi zatamnjivala ekran.
span.modal-status-icon
Generiše JS
Statusna SVG ikonica na levoj strani notifikacije (boja zavisi od type atributa).
toast-content
Generiše JS
Unutrašnji omotač u koji JS automatski smešta tekst poruke.
modal-close
Generiše JS
Malo dugme X (20px x 20px) na desnoj strani notifikacije za ručno zatvaranje.
Podržani HTML Atributi
Atribut
Moguće vrednosti
Detaljan opis ponašanja
type="info"
"info"
Prikazuje plavu informacionu SVG ikonicu (#3498db).
type="success"
"success"
Prikazuje zelenu SVG ikonicu uspeha (#2ecc71).
type="warning"
"warning"
Prikazuje žutu SVG ikonicu upozorenja (#f1c40f).
type="error"
"error"
Prikazuje crvenu SVG ikonicu greške (#e74c3c).
duration
Broj sekundi (npr. "4") ili "0"
Određuje posle koliko sekundi će se notifikacija sama zatvoriti. Podrazumevana vrednost je 4. Ako se postavi na 0, notifikacija se neće sama ugasiti dok korisnik ne klikne na X.
position="bottom-right"
"bottom-right"
Smešta notifikaciju u donji desni ugao ekrana (podrazumevana pozicija). Nove poruke se slažu nagore.
position="bottom-left"
"bottom-left"
Smešta notifikaciju u donji levi ugao ekrana. Nove poruke se slažu nagore.
position="bottom-center"
"bottom-center"
Smešta notifikaciju na dno ekrana po sredini. Nove poruke se slažu nagore.
position="top-right"
"top-right"
Smešta notifikaciju u gornji desni ugao ekrana. Nove poruke se slažu nadole.
position="top-left"
"top-left"
Smešta notifikaciju u gornji levi ugao ekrana. Nove poruke se slažu nadole.
position="top-center"
"top-center"
Smešta notifikaciju na vrh ekrana po sredini. Nove poruke se slažu nadole.
Globalna funkcija koja dinamički kreira <modal-toast> element u document.body, prikazuje ga, slaže u niz sa ostalim aktivnim porukama i automatski ga uklanja iz DOM-a kada se zatvori.
Nasleđuje ModalBox i vodi korisnika kroz više koraka (<wizard-step>). Automatski generiše gornju traku sa indikatorima koraka, upravlja vidljivošću dugmića (Prethodno / Sledeće / Završi) i vrši validaciju polja pre prelaska na naredni korak.
Unutrašnji tagovi i CSS selektori u okviru <modal-wizard>
Tag / Selektor
Poreklo
Opis i šta stilizuje u CSS-u
modal-wizard
Piše korisnik
Glavni kontejner čarobnjaka.
modal-wizard:popover-open
CSS stanje
Aktivno stanje kada je čarobnjak otvoren (display: flex; flex-direction: column;).
modal-wizard::backdrop
Pseudo-element
Zatamnjena i zamućena pozadina iza čarobnjaka.
modal-close
Generiše JS
Dugme X u gornjem desnom uglu.
modal-header
Piše korisnik
Glavni naslov čarobnjaka na vrhu prozora.
wizard-steps-nav
Generiše JS
Horizontalna traka sa indikatorima svih koraka koja se automatski ubacuje odmah ispod <modal-header>-a.
.wizard-step-indicator
Generiše JS
Pojedinačni indikator koraka (sadrži broj i naziv koraka). Podrazumevano je poluprovidan (opacity: 0.45) dok korak ne postane aktivan ili završen.
.wizard-step-indicator.active
CSS stanje
Indikator trenutno aktivnog koraka (opacity: 1, kružni broj dobija plavu pozadinu #3498db).
.wizard-step-indicator.completed
CSS stanje
Indikator uspešno pređenog koraka (opacity: 1, kružni broj dobija zelenu pozadinu #2ecc71).
.wizard-step-number
Generiše JS
Kružni bedž (24px x 24px) sa rednim brojem koraka (1, 2, 3...).
.wizard-step-label
Generiše JS
Tekstualni naziv koraka pored kružnog broja (preuzet iz title atributa na <wizard-step>).
wizard-step
Piše korisnik
Kontejner pojedinačnog koraka. Samo trenutno aktivni korak ima display: block, dok su ostali sakriveni.
modal-footer
Generiše JS ili piše korisnik
Donja traka u koju JS automatski smešta <wizard-previous>, <wizard-next> i <wizard-finish> dugmad.
wizard-previous
Piše korisnik ili JS
Dugme za povratak na prethodni korak. Na prvom koraku automatski dobija visibility: hidden.
wizard-next
Piše korisnik ili JS
Plavo dugme (#3498db) za prelazak na sledeći korak. Na poslednjem koraku se automatski sakriva (display: none).
wizard-finish
Piše korisnik ili JS
Zeleno dugme (#2ecc71) za završetak čarobnjaka. Prikazuje se isključivo na poslednjem koraku.
Podržani HTML Atributi
Atribut
Na kom tagu se piše
Detaljan opis ponašanja
title
<wizard-step>
Određuje naziv tog koraka u gornjoj traci indikatora (npr. <wizard-step title="Mreža">). Ako se izostavi, ispisuje se "Korak 1", "Korak 2" itd.
prev-text
<modal-wizard>
Tekst za dugme "Nazad" ukoliko u HTML-u nije ručno napisan tag <wizard-previous> (podrazumevano "Nazad").
next-text
<modal-wizard>
Tekst za dugme "Dalje" ukoliko u HTML-u nije ručno napisan tag <wizard-next> (podrazumevano "Sledeće").
finish-text
<modal-wizard>
Tekst za završno dugme ukoliko u HTML-u nije ručno napisan tag <wizard-finish> (podrazumevano "Završi").
persistent
<modal-wizard>
Sprečava slučajno zatvaranje čarobnjaka klikom na sivu pozadinu ili pritiskom na Escape.
locked
<modal-wizard>
Sprečava zatvaranje na pozadinu/ESC i sakriva X dugme, tako da korisnik mora da prođe sve korake do kraja.
forced
<modal-wizard>
Isto kao locked, plus blokira osvežavanje (F5) ili napuštanje stranice dok se čarobnjak ne završi.
JavaScript Metode i Događaji
Metoda / Događaj
Parametri
Detaljan opis
wizard.show()
nema
Otvara čarobnjak na koraku na kom se trenutno nalazi.
wizard.hide()
nema
Zatvara čarobnjak.
wizard.nextStep()
nema
Pokreće validaciju trenutnog koraka (HTML5 polja + custom validator + step-validate događaj) i, ako je sve ispravno, prelazi na sledeći korak.
wizard.prevStep()
nema
Vraća korisnika na prethodni korak bez pokretanja validacije.
wizard.goToStep(index, validateForward)
index: broj koraka (od 0) validateForward: boolean (default true)
Prebacuje prikaz na zadati indeks koraka. Ako je validateForward = true i prelazi se unapred, prvo proverava ispravnost trenutnog koraka.
wizard.reset()
nema
Vraća čarobnjak na prvi korak (indeks 0) bez pokretanja validacije.
wizard.finish()
nema
Pokreće validaciju poslednjeg koraka; ako je uspešna, okida događaj wizard-finish i zatvara modal.
wizard.setValidator(fn)
fn: (stepIndex, stepEl) => boolean
Postavlja tvoju JavaScript funkciju za validaciju. Funkcija dobija indeks trenutnog koraka (0, 1...) i DOM element tog <wizard-step>-a. Ako vrati false, prelazak na sledeći korak se blokira.
wizard.persistent(state)
state: true ili false
Dinamički uključuje ili isključuje persistent režim.
wizard.locked(state)
state: true ili false
Dinamički uključuje ili isključuje locked režim.
wizard.forced(state)
state: true ili false
Dinamički uključuje ili isključuje forced režim.
addEventListener('step-change', fn)
CustomEvent
Okida se pri svakoj promeni koraka. U event.detail.step nalazi se indeks novog aktivnog koraka.
addEventListener('step-validate', fn)
CustomEvent (otkaziv)
Okida se pre prelaska na naredni korak. Sadrži event.detail.step i event.detail.stepElement. Pozivanjem event.preventDefault() možeš blokirati prelazak.
addEventListener('wizard-finish', fn)
CustomEvent
Okida se kada korisnik uspešno klikne na završno dugme (<wizard-finish>) na poslednjem koraku.
addEventListener('toggle', fn)
event objekat
Nativni događaj otvaranja i zatvaranja prozora.
Interaktivni primer za <modal-wizard>
Podešavanje LPR čvora
Probaj da obrišeš polje ili upišeš 10.0.0.1 pa klikni na "Sledeće" da vidiš validaciju.
Svi parametri su provereni i spremni za upis u konfiguraciju.